Add a Go example exercising hostedtool.MCPServer with the OpenAI Responses provider by PratikDhanave · Pull Request #665 · microsoft/agent-framework-go

PratikDhanave (PratikDhanave) · 2026-07-23T08:21:04Z

What

Adds a new example examples/02-agents/providers/openai/hosted_mcp/main.go that wires a hosted MCP server into an OpenAI Responses agent.

The example:

builds an OpenAI Responses agent via openaiprovider.NewResponsesAgent,
attaches []tool.Tool{&hostedtool.MCPServer{...}} pointing at the public Microsoft Learn MCP endpoint (https://learn.microsoft.com/api/mcp) with AllowedTools set,
runs the agent and iterates the response contents, printing any *message.MCPServerToolCallContent and hosted-MCP *message.ToolApprovalRequestContent,
guards the live run behind an OPENAI_API_KEY check, printing a skip message when it is absent (consistent with the other provider examples).

It is registered in the cmd/verifyexamples harness alongside the existing hosted-tool examples (foundry step14_code_interpreter, step21_web_search, step23_local_mcp).

Why

provider/openaiprovider/responses.go already maps *hostedtool.MCPServer onto responses.ToolMcpParam (server label, server URL/connector id, description, allowed tools, headers, authorization), but no example exercised it — hostedtool.MCPServer did not appear anywhere under examples/. The existing examples only wired hostedtool for CodeInterpreter and WebSearch. This mirrors the .NET and Python SDKs, which each ship a hosted-MCP agent sample, and fills the missing OpenAI Responses variant for cross-SDK parity. The example follows the same structure as the existing hosted-tool step examples.

Testing

go build ./...
go vet ./examples/... ./cmd/verifyexamples/...
go test ./cmd/verifyexamples/...

all pass. The example is a docs/example addition; its live body is env-gated so it compiles and vets without credentials.

Copilot

Pull request overview

Adds a new OpenAI Responses provider example demonstrating how to wire a hosted MCP server (hostedtool.MCPServer) into an agent, and registers that example with the cmd/verifyexamples harness.

Changes:

Added examples/02-agents/providers/openai/hosted_mcp/main.go to run an OpenAI Responses agent with the Microsoft Learn hosted MCP endpoint and print MCP tool-call / approval-request contents.
Registered the new example in cmd/verifyexamples/examples.go so it can be verified (env-gated on OPENAI_API_KEY).

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File	Description
examples/02-agents/providers/openai/hosted_mcp/main.go	New example showing a hosted MCP server tool used through an OpenAI Responses agent and printing MCP-related response contents.
cmd/verifyexamples/examples.go	Adds the new hosted MCP example to the verifyexamples registry with `OPENAI_API_KEY` gating.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Add examples/02-agents/providers/openai/hosted_mcp demonstrating the hostedtool.MCPServer tool with an OpenAI Responses agent. It attaches a remote hosted MCP server (Microsoft Learn), runs the agent, and inspects the response for MCPServerToolCallContent and MCP approval requests. The live run is guarded behind an OPENAI_API_KEY check. Register the example in the verifyexamples harness alongside the other hosted-tool examples.

# Conflicts: # cmd/verifyexamples/examples.go

github-actions · 2026-08-22T04:31:41Z

Parity Review — PR #665

Scope

This PR adds one new example file (examples/02-agents/providers/openai/hosted_mcp/main.go) and registers it in the cmd/verifyexamples harness. No exported Go types, functions, or methods are added or changed.

Cross-SDK Sample Alignment

The hosted-MCP scenario is covered in both upstream SDKs:

Python: python/samples/02-agents/providers/openai/client_with_hosted_mcp.py — demonstrates never_require, always_require, and selective-approval modes with and without sessions
.NET: dotnet/samples/02-agents/ModelContextProtocol/ResponseAgent_Hosted_MCP/Program.cs — demonstrates NeverRequire and AlwaysRequire modes with ToolApprovalRequestContent handling

The Go example fills the previously missing OpenAI Responses variant for this scenario. It targets the no-explicit-approval-mode variant (analogous to never_require in Python), uses microsoft_docs_search via AllowedTools, and correctly inspects *message.MCPServerToolCallContent and *message.ToolApprovalRequestContent from the response — matching the intent of both upstream samples.

Pre-existing Structural Note (not introduced by this PR)

The Go hostedtool.MCPServer struct currently has no ApprovalMode field. Both Python (approval_mode kwarg) and .NET (HostedMcpServerToolApprovalMode enum) expose explicit approval-mode control, so the Go SDK cannot yet demonstrate the interactive approval workflow shown in the upstream samples. This gap predates this PR and is out of scope here, but maintainers may want to track it as a follow-up.

Verdict

✅ No parity issues introduced by this PR. The example aligns in concept, endpoint, and response-inspection pattern with the upstream Python and .NET samples. No exported Go API surface changed.

Generated by Go API Consistency Review Agent · sonnet46 · 32.5 AIC · ⌖ 5.79 AIC · ⊞ 6K · ◷

Copilot AI review requested due to automatic review settings July 23, 2026 08:21

PratikDhanave (PratikDhanave) requested a review from a team as a code owner July 23, 2026 08:21

Copilot started reviewing on behalf of PratikDhanave (PratikDhanave) July 23, 2026 08:21 View session

Copilot AI reviewed Jul 23, 2026

View reviewed changes

Comment thread examples/02-agents/providers/openai/hosted_mcp/main.go